이 문서는 서버 설치에서 Trilium 자체에 TLS를 설정하는 방법을 설명합니다. Nginx 같은 역방향 프록시에서 HTTPS 연결을 처리하는 방식도 사용할 수 있습니다. 원문에 연결된 역방향 프록시 설정 예제는 특정 Ubuntu 버전 기준입니다.

인증서 준비

신뢰할 수 있는 인증 기관이 서명한 인증서를 사용하는 것이 일반적입니다. Let’s Encrypt는 무료 인증서를 제공하며 Certbot 등의 도구로 발급과 갱신을 자동화할 수 있습니다. 자체 서명 인증서도 가능하지만 접속하는 기기마다 신뢰 설정이 필요합니다.

config.ini 설정

데이터 폴더의 설정 파일에 인증서와 키 경로를 지정합니다.

[Network]
port=8080
# HTTPS를 사용하려면 true로 지정합니다. false는 HTTP입니다.
https=true
# 인증서 경로입니다. 자체 서명 인증서 생성 예시는 bash bin/generate-cert.sh입니다.
# https=true일 때 사용합니다.
certPath=/[username]/.acme.sh/[hostname]/fullchain.cer
keyPath=/[username]/.acme.sh/[hostname]/example.com.key

환경 변수 설정으로 같은 값을 전달할 수도 있습니다. 예제 경로는 ACME 도구를 사용한 환경의 예시이며 실제 파일 위치에 맞게 바꿔야 합니다. Docker에서는 컨테이너가 접근할 수 있는 마운트 경로를 지정하세요. 설정 후 Trilium을 다시 시작하고 HTTPS 주소로 접속합니다.

자체 서명 인증서

데스크톱 앱은 자체 서명 인증서를 기본적으로 신뢰하지 않습니다. 원문에는 다음처럼 인증서 검증을 끄는 방법도 소개되어 있습니다.

export NODE_TLS_REJECT_UNAUTHORIZED=0
trilium

Windows의 trilium-no-cert-check.bat도 같은 용도의 시작 스크립트입니다. 인증서 검증을 끄면 서버의 신원을 확인하지 못하므로 연결 보안이 약해집니다. 이 설명은 기능 안내이며 이 한글화 작업에서는 해당 설정을 변경하지 않습니다.